Tootsville::Endpoint-Delete-/ Users/ Me/ Toots/ Toot-Name→Json

Function

Endpoint-Delete-/ Users/ Me/ Toots/ Toot-Name→Json names a function, with lambda list (TOOT-NAME):

Permanently destroys the Toot character TOOT-NAME.

This Toot must be owned by you (the logged-in user).

Any inventory held by the Toot, or property owned by the Toot, will be released to the public domain. Players should transfer items or property prior to deleting a Toot.

For a time after a Toot's deletion, their name remains locked (to prevent immediate impersonation).

Requires player authentication.

Status: 202 Toot deletion in progress

The Toot will be deleted, but it may not have completed yet. A subsequent, identical request can confirm.

Status: 204 Toot deleted

The Toot has been deleted. Repeated calls will return the same status, for the duration of the name lock on the Toot.

Status: 401 Authorization Required

No user credentials were passed.

Status: 403 Authorization Failed

The user credentials presented were not recognized.

Status: 404 Not Found

The Toot named does not exist.

Status: 405 Not Allowed

The Toot named is one that you have permission to use, but are not the main owner of. This is usually a child account.

Web Service Endpoint

This is a web service endpoint accessed by the HTTP method DELETE at the URI template /users/me/toots/:toot-name. It returns a content-type of application/json.

TOOT-NAME is a parameter from the URI.

It will report a slow response if it takes longer than 0.03 seconds (30 milliseconds) to complete.

File

Defined in file src/endpoints/slash-users.lisp.